Skip to content

docs(snapshots): Add agentic workflow page#17939

Merged
cameroncooke merged 2 commits into
masterfrom
cameroncooke/docs/snapshots-agentic-workflow
Jun 2, 2026
Merged

docs(snapshots): Add agentic workflow page#17939
cameroncooke merged 2 commits into
masterfrom
cameroncooke/docs/snapshots-agentic-workflow

Conversation

@cameroncooke
Copy link
Copy Markdown
Contributor

@cameroncooke cameroncooke commented Jun 1, 2026

DESCRIBE YOUR PR

Adds a new Snapshots documentation page, Agentic Workflow, covering how to use Sentry's MCP server to investigate snapshot results with an AI coding assistant (Claude Code, Cursor, VS Code, and others) instead of clicking through the Sentry UI or downloading images by hand.

  • Explains connecting to the Sentry MCP server (endpoints and OAuth)
  • Documents the optional Preprod Snapshots capability: what the agent can do by default via get_sentry_resource versus the advanced tools it unlocks (get_snapshot, get_snapshot_image, get_latest_base_snapshot), plus the context-window tradeoff
  • Walks through four agent use-cases: investigate a failed CI snapshot check, inspect a changed image, triage before approving, and look up an app's latest baseline
  • Points to sentry-cli and Local Testing for local download and diff workflows

The page sits in the Snapshots section (sidebar_order: 30) and is gated behind the Early Adopter include. Tool names, parameters, and the example responses were verified against the live Sentry MCP server.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Jun 2, 2026 10:30am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Jun 2, 2026 10:30am

Request Review

Add a Snapshots child page that explains how to use Sentry MCP for
agent-assisted snapshot investigation. Cover setup, Preprod Snapshots tool
selection, snapshot URL handling, primitive snapshot tools, and when to use
CLI workflows instead.

Co-Authored-By: Claude Code Opus <noreply@example.com>
@cameroncooke cameroncooke force-pushed the cameroncooke/docs/snapshots-agentic-workflow branch from 59371a5 to 2c71066 Compare June 1, 2026 11:42
@cameroncooke cameroncooke marked this pull request as ready for review June 1, 2026 11:46
Comment thread docs/product/snapshots/agentic-workflow/index.mdx
Comment thread docs/product/snapshots/agentic-workflow/index.mdx
Add note that while the Sentry MCP is optimized for agentic workflows,
users can also fetch snapshot data via the REST API and expose scripts
to agents.

Co-Authored-By: Claude <noreply@anthropic.com>

Co-authored-by: Cameron Cooke <web@cameroncooke.com>
<Alert level="info">
The Sentry MCP has been optimized to retrieve Snapshot results for agentic
workflows. If you'd like, you can also fetch the data via the [REST
API](/api/snapshots/) and expose scripts to agents.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: The link to the REST API documentation for snapshots at /api/snapshots/ is broken because the target page does not exist.
Severity: LOW

Suggested Fix

Verify the correct path for the Snapshots API documentation. If the page exists at a different URL, update the link's href attribute. If the documentation page does not exist, either remove the link or create the missing documentation page.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: docs/product/snapshots/agentic-workflow/index.mdx#L18

Potential issue: The documentation file
`docs/product/snapshots/agentic-workflow/index.mdx` contains a markdown link to
`[API](/api/snapshots/)`. However, the target path `/api/snapshots/` does not correspond
to any existing file or redirect rule within the documentation site. As a result, any
user clicking this link will encounter a 404 'Not Found' error. This creates a broken
cross-reference in the documentation, degrading the user experience for those trying to
find the API documentation for snapshots.

Did we get this right? 👍 / 👎 to inform future reviews.

@cameroncooke cameroncooke merged commit 88de69b into master Jun 2, 2026
21 checks passed
@cameroncooke cameroncooke deleted the cameroncooke/docs/snapshots-agentic-workflow branch June 2, 2026 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants